home *** CD-ROM | disk | FTP | other *** search
/ Aminet 47 / Aminet 47 (2002)(GTI - Schatztruhe)[Feb 2002].iso / Aminet / mus / misc / MpegDoct-r.readme < prev   
Text File  |  2001-11-05  |  4KB  |  109 lines
  1. Short:    Tries to repair corrupt Mpeg audio files
  2. Author:   radiat-r@sascha-ploss.de (radiat-r aka Sascha Ploss)
  3. Uploader: radiat-r@sascha-ploss.de (radiat-r aka Sascha Ploss)
  4. Version:  0.2   (15 Oct 2000)
  5. Type:     mus/misc
  6.  
  7. Introduction:
  8.  
  9.  - MpegDoct-r is based on MpegAnalys-r which scans a whole Mpeg
  10.    (all types supported) and detects any errors regarding the
  11.    framesize or header. Then it tries to determine and restore the
  12.    original frame structure. This is important as some players
  13.    (software- or hardware-based) may have problems with corrupted
  14.    files.
  15.  
  16.  
  17. Disclaimer:
  18.  
  19.  - Use at your own risk! I cannot be held responsible for
  20.    any damage it may cause, either to hardware or to software.
  21.  
  22.  
  23. Requirements:
  24.  
  25.  - Should run on almost every Amiga with installed ixemul.library.
  26.  
  27.  
  28. Installation:
  29.  
  30.  - After extracting the archive, just copy the executable anywhere
  31.    you want it (I recommend to put it somewhere in your path, e.g. sys:c)
  32.  
  33.  
  34. Usage:
  35.  
  36.  MpegDoct-r <InputFile> <OutputFile> [infolevel]
  37.  
  38.  
  39. Required parameter:
  40.  
  41.   <InputFile>             - any Mpeg audio file,
  42.                             if the filename contains spaces, it must be
  43.                             enclosed in braces like this: "Hello World.mp3"
  44.  
  45.   <OutputFile>            - the name of the outputfile.
  46.                             Must not be equal to <InputFile>.
  47.                             Warning: no check is performed if a file with
  48.                             that name already exists, so be careful!
  49.                             if the filename contains spaces, it must be
  50.                             enclosed in braces like this: "Hello World.mp3"
  51.  
  52. Optional parameters:
  53.  
  54.   [infolevel]             - a number from 0 to 2, which specifies the amount of
  55.                             displayed information, 0 is default when omitted.
  56.                              0: only errors are displayed and a short summary,
  57.                              1: number, position and status of each frame is displayed,
  58.                              2: like 1, but additionally Mpeg id, layer type,
  59.                                 bitrate and frequency is shown for each frame
  60.  
  61. Examples:
  62. MpegDoct-r damaged.mp3 repaired.mp3
  63.        (standard repair mode, display only errors and summary)
  64.  
  65. MpegDoct-r damaged.mp3 repaired.mp3 2
  66.        (repair and display most detailed information about each frame)
  67.  
  68. MpegDoct-r "Damaged File.mp3" "Repaired File.mp3" 2
  69.        (same like above but with space in filename)
  70.  
  71.  
  72. Bugs and disfunctionals:
  73.  
  74.  - If you find anything, PLEASE mail me and i'll try to fix it.
  75.  
  76.  - If you encounter strange behavior or crashes, try to increase the stack first.
  77.  
  78.  - If no TAG is present at the end of the file the last frame is replaced with
  79.    the one before.
  80.  
  81.  - MpegDoct-r can only repair the frame structure but not the raw audio data itself.
  82.    If the audio is corrupt MpegDoct-r cannot guess how it should look like or might
  83.    have sounded before the damage. So the program maybe solves your problem, or maybe
  84.    it doesn't.
  85.  
  86.  - There is a problem with invalid Tags inside the file. As there are different
  87.    possibilities how they got into the file MpegDoct-r cannot guess which method
  88.    to use to remove them.
  89.  
  90.  - Also try to run the program on the repaired file once more if MpegAnalys-r still
  91.    shows errors. Some problems can not be recovered in a single run.
  92.  
  93.  - very slow
  94.  
  95.  
  96. History:
  97.  
  98.  0.2:         - First public release
  99.  
  100.  
  101. Thankz:
  102.  
  103.  - Lee "TLT" Trice for betatesting
  104.  
  105.  
  106. Please mail me if you use it: radiat-r@sascha-ploss.de
  107. Check out my Amiga pages with more Amiga stuff:
  108. http://www.Global-Multimedia.de/amiga/
  109.